Configure high-availability cluster settings for a specific appliance

Request

Applicable to appliances only.

Security

JWTAuthorizer

Path

nodeIDstringrequired

Node ID

Bodyapplication/jsonrequired

enabledboolean

Whether the node participates in an HA cluster

hoststring

Peer IP or hostname used for cluster heartbeat and state sync

portinteger

TCP port used for cluster heartbeat and state sync

statusHoststring

Optional dedicated host used for cluster status checks

statusPortinteger

Optional dedicated port used for cluster status checks

masterboolean

True when this node is currently the active master of the cluster pair

updateTimeinteger

Unix timestamp of the last cluster config change

versionCounterinteger

Monotonically increasing config version counter

masterVersioninteger

Config version currently held by the cluster master

curl -i -X PUT \
  'https://apidocs.trustgrid.io/_mock/node/{nodeID}/config/cluster' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>' \
  -H 'Content-Type: application/json' \
  -d '{
    "enabled": true,
    "host": "string",
    "port": 0,
    "statusHost": "string",
    "statusPort": 0,
    "master": true,
    "updateTime": 0,
    "versionCounter": 0,
    "masterVersion": 0
  }'

Responses

OK